<?php
// $Id$

/**
 * Product_Categories 封装来自 product_categories 数据表的记录及领域逻辑
 */
class Product_Categories extends QDB_ActiveRecord_Abstract
{

	/**
	 * 返回对象的定义
	 *
	 * @static
	 *
	 * @return array
	 */
	static function __define()
	{
		return array
		(
			// 指定该 ActiveRecord 要使用的行为插件
			'behaviors' => '',

			// 指定行为插件的配置
			'behaviors_settings' => array
			(
			    # '插件名' => array('选项' => 设置),
			),

			// 用什么数据表保存对象
			'table_name' => 'product_categories',

			// 指定数据表记录字段与对象属性之间的映射关系
			// 没有在此处指定的属性，QeePHP 会自动设置将属性映射为对象的可读写属性
			'props' => array
			(
				// 主键应该是只读，确保领域对象的“不变量”
				'id' => array('readonly' => true),

				/**
				 *  可以在此添加其他属性的设置
				 */
				# 'other_prop' => array('readonly' => true),

				/**
				 * 添加对象间的关联
				 */
				# 'other' => array('has_one' => 'Class'),

			),

			/**
			 * 允许使用 mass-assignment 方式赋值的属性
			 *
			 * 如果指定了 attr_accessible，则忽略 attr_protected 的设置。
			 */
			'attr_accessible' => '',

			/**
			 * 拒绝使用 mass-assignment 方式赋值的属性
			 */
			'attr_protected' => 'id',

			/**
			 * 指定在数据库中创建对象时，哪些属性的值不允许由外部提供
			 *
			 * 这里指定的属性会在创建记录时被过滤掉，从而让数据库自行填充值。
			 */
			'create_reject' => '',

			/**
			 * 指定更新数据库中的对象时，哪些属性的值不允许由外部提供
			 */
			'update_reject' => '',

			/**
			 * 指定在数据库中创建对象时，哪些属性的值由下面指定的内容进行覆盖
			 *
			 * 如果填充值为 self::AUTOFILL_TIMESTAMP 或 self::AUTOFILL_DATETIME，
			 * 则会根据属性的类型来自动填充当前时间（整数或字符串）。
			 *
			 * 如果填充值为一个数组，则假定为 callback 方法。
			 */
			'create_autofill' => array
			(
				# 属性名 => 填充值
				# 'is_locked' => 0,
			),

			/**
			 * 指定更新数据库中的对象时，哪些属性的值由下面指定的内容进行覆盖
			 *
			 * 填充值的指定规则同 create_autofill
			 */
			'update_autofill' => array
			(
			),

			/**
			 * 在保存对象时，会按照下面指定的验证规则进行验证。验证失败会抛出异常。
			 *
			 * 除了在保存时自动验证，还可以通过对象的 ::meta()->validate() 方法对数组数据进行验证。
			 *
			 * 如果需要添加一个自定义验证，应该写成
			 *
			 * 'title' => array(
			 *	array(array(__CLASS__, 'checkTitle'), '标题不能为空'),
			 * )
			 *
			 * 然后在该类中添加 checkTitle() 方法。函数原型如下：
			 *
			 * static function checkTitle($title)
			 *
			 * 该方法返回 true 表示通过验证。
			 */
			'validations' => array
			(
			),
		);
	}


/* ------------------ 以下是自动生成的代码，不能修改 ------------------ */

	/**
	 * 开启一个查询，查找符合条件的对象或对象集合
	 *
	 * @static
	 *
	 * @return QDB_Select
	 */
	static function find()
	{
		$args = func_get_args();
		return QDB_ActiveRecord_Meta::instance(__CLASS__)->findByArgs($args);
	}

	/**
	 * 返回当前 ActiveRecord 类的元数据对象
	 *
	 * @static
	 *
	 * @return QDB_ActiveRecord_Meta
	 */
	static function meta()
	{
		return QDB_ActiveRecord_Meta::instance(__CLASS__);
	}


/* ------------------ 以上是自动生成的代码，不能修改 ------------------ */
	
	/**
	 * 取得分类树
	 * @param $parent_id 父级分类id
	 * @param $categories 需要查找的分类列
	 * @return 分类树 
	 */
	static function getCategoriesTree($parent_id=0, $categories=array())
	{
		if ( ! $categories)
		{
			$categories = Product_Categories::find()->asArray()->getAll();
		}
		$children_categories = Helper_BSS_Array::Search($categories, 'parent_id', $parent_id);
		$ret = array();
		foreach ($children_categories as $cc)
		{
			$ret[$cc['id']]['name'] = $cc['name'];
			$ret[$cc['id']]['children'] = Product_Categories::GetCategoriesTree($cc['id'], $categories);
		}
		return $ret;
	}
	
	/**
	 * 通过分类id找祖先
	 * @param $id 分类id
	 * @return 祖先数组
	 */
	static function getAncestorById($id)
	{
		$categories = Product_Categories::find('id=?', $id)->asArray()->getOne();
		if ($categories)
		{
			$ret = Product_Categories::GetAncestorById($categories['parent_id']);
			array_push($ret, $categories);
			return $ret;
		}
		else
		{
			return array();
		}
	}

	/**
	 * 通过分类id找祖先
	 * @param $id 分类id
	 * @return 祖先名称数组
	 */
	static function getAncestorNameById($id)
	{
		$categories = Product_Categories::find('id=?', $id)->asArray()->getOne();
		if ($categories)
		{
			$ret = Product_Categories::GetAncestorNameById($categories['parent_id']);
			array_push($ret, $categories['name']);
			return $ret;
		}
		else
		{
			return array();
		}
	}
	
	/**
	 * 通过分类id找子孙id
	 * @param $id 分类id
	 * @return 子孙id
	 */
	static function getOffspringById($id)
	{
		$categories = Product_Categories::find('parent_id=?', $id)->asArray()->getAll();
		if ($categories)
		{
			$result = array();
			foreach ($categories as $c)
			{
				$result[] = $c['id'];
				$ret = Product_Categories::GetOffspringById($c['id']);
				$result = array_merge($result, $ret);
			}
			return $result;
		}
		else
		{
			return array();
		}
	}
	
	/**
	 * 产品分类新建保存
	 * @param $parent_id 产品分类父级id
	 * @param $name 产品分类名称
	 * @return 保存成功（失败）和分类id
	 */
	static function create($parent_id, $name)
	{
		if(Helper_Plu_Number::$status)
		{
			$number_prefix = trim($_POST['number_prefix']);
			$check_status = Helper_Plu_Number::checkNumberPrefix($number_prefix, $parent_id);
			if(!$check_status)
			return array('ack' => FAILURE, 'message' => 'number prefix is exists!');
		}
		
		$categories = Product_Categories::find('name =? and parent_id =?', $name, $parent_id)->asArray()->getOne();
		if ($categories)
		{
			return array('ack' => FAILURE, 'message' => 'categories is exists!', 'categories_id' => $categories['id']);
		}
		else
		{
			$categories = new Product_Categories();
			$categories->name = $name;
			(Helper_Plu_Number::$status)?$categories->number_prefix = $number_prefix:'';
			$categories->parent_id = $parent_id;
			$categories->create_time = CURRENT_DATETIME;
			$categories->last_edit_time = CURRENT_DATETIME;
			$categories->save();
			Product_Categories::update(mysql_insert_id(), $parent_id);
			return array('ack' => SUCCESS, 'message' => '', 'categories_id' => $categories['id']);
		}
	}
	
	/**
	 * 产品分类新建子类时，挂载父类产品到子类下
	 * @param 当前子类 $product_categories_id
	 * @param 父类 $parent_id
	 */
	static function update($product_categories_id, $parent_id)
	{
		$parent_categories_product_in_db = Product_basic::find('product_categories_id=?', $parent_id)->getAll();
		if ($parent_categories_product_in_db)
		{
			foreach ($parent_categories_product_in_db as $pcpid)
			{
				$pcpid->product_categories_id = $product_categories_id;
				$pcpid->save();
			}
		}
		return array('ack' => SUCCESS, 'message' => '');
	}
	
	/**
	 * 产品分类编辑
	 * @param $id 需要编辑的产品分类id
	 * @param $name 产品分类名称
	 * @return 编辑成功（失败）
	 */
	static function edit($id, $name)
	{
		$categories = Product_Categories::find('id=?', $id)->getOne();
		$result = Product_Categories::find('name=? and id<>? and parent_id=?', $name, $id, $categories['parent_id'])->asArray()->getOne();
		if ( ! $name)
		{
			return array('ack' => FAILURE, 'message' => 'product name is null!');
			
		}
		if ($categories['id'] && ! $result)
		{
			$categories->name = $name;
			$categories->last_edit_time = CURRENT_DATETIME;
			$categories->save();
			return array('ack' => SUCCESS, 'message' =>'');
		}
	}
	
	/**
	 * 产品分类删除
	 * @param $id 需要删除的产品分类id
	 * @return 删除成功（失败）
	 */
	static function delete($id)
	{
		$categories = Product_Categories::find('id=?', $id)->asArray()->getOne();
		if ($categories)
		{
			$children = Product_Categories::find('parent_id=?', $id)->asArray()->getOne();
			if ($children)
			{
				return array('ack' => FAILURE, 'message' => 'child categories is exists!');
			}
			else
			{
				$product = Product_Basic::find('product_categories_id=?', $id)->asArray()->getOne();
				if ($product)
				{
					return array('ack' => FAILURE, 'message' => 'product is exists!');
				}
				else
				{
					Product_Categories::meta()->deleteWhere('id=?', $id);
					return array('ack' => SUCCESS, 'message' => '');
				}
			}
		}
	}
}


